Operating Systems: Macintosh 


Macintosh Resources 


Resources form the backbone of the Macintosh’s consistent user interface. 


In this article, we describe these essential file elements, and show you how to 


customize them in order to make full use of the Macintosh’s operating system. 


| J NKNOWN TO MOST Macin- 
tosh users, lurking within 
each file are file elements, 
called resources, which control much 
of the way the Mac works. 

Among the large list of resource 
types are menus, windows, dialog 
boxes, alerts, icons, cursors, fonts, desk 
accessories, programming code, and 
layout information (see Table 1 for a 
list of the more common resources 
and their uses). Any of these can be 
altered to give the Macintosh Operat- 
ing System a more personal feel, or to 
more accurately reflect the needs of 
the user. 


Resource vs Data 


Each Mac file has a Data Fork and/or 
a Resource Fork. The Data Fork is used 
by programs such as word processors 
to store the text of the document, or by 
graphics programs to store the infor- 
mation needed to draw the image. 
The Resource Fork contains any of the 
valid resource types for that file. An 
application program’s resources are 
determined by the needs of the pro- 
gram itself; a data file’s resource types 
are determined by the application 
which produced the file. 

There are, in addition to the appli- 
cation-specific resources, generic re- 
sources used by most types of appli- 
cations. For example, icons, menus, 
dialogs, alerts, and fonts are used by 
most applications to conform to the 
standard Macintosh Interface. 

More than anything else, resources 
form the backbone of this consistent 
interface: applications access common 
resource types from the System File; 
menus look and work the same 
way across applications. Without re- 
sources, developers would have to 
code every facet of their programs’ 
operations, rather than focus on the 
specific operations the program is to 
carry out. 

There are approximately 120 com- 


monly used resources, with numer- 
ous custom types used by applica- 
tions. Each type of resource is assigned 
a4-character name, which can include 
almost any of the 256 standard Macin- 
tosh characters. Each resource within 
a resource type has a unique ID, and 
can also have a name assigned. 

Note: All resource names contain- 
ing only lower-case letters are reserved 
by Apple for its own use. It is recom- 
mended that you do not use resource 
names which match existing resource 
names, regardless of differing case in 
the names (for example, you shouldn’t 
use ‘Font’ as a resource name as there 
is already a resource type ‘FONT’). 
All resource types must contain four 
characters — spaces can be used to pad 
the name to four characters. 


ResEdit 


Since the early days of the Macintosh, 
Apple has provided users with a pro- 
gram for creating and modifying re- 
sources. This program, ResEdit, went 
through several revisions before ver- 
sion 2.1 was distributed as the first 
official release version (previous ver- 
sions were Officially beta-test). 
Although primarily aimed at the de- 
veloper market, ResEdit is widely 
available on bulletin boards and pub- 
lic domain lists. All references in this 
article refer to ResEdit Version 2.1 only. 

ResEdit lets you open a file and 
carry out alterations to the resources 
within it. When a file is opened, a list 
of resource types (either in icon or list 
view) is presented. You can select ei- 
ther all the resources for cutting or 
copying, or you can double click on a 
particular resource type to show all 
available resources of that type. Once 
you have selected a particular resource 
type, you can cut, copy or paste any or 
all resources of that type. Double click- 
ing ona particular resource will allow 
editing of that resource. File and folder 
attributes can also be changed with 


ResEdit. 

The type of resource selected de- 
termines the editor which is called 
when the resource is opened. ResEdit 
has its own resource type, TMPL, 
which contains templates for anumber 
of resource editors. If ResEdit does 
not have a template for the resource 
type opened, the user can either open 
it with the hexadecimal editor, or force 
ResEdit to open it using another tem- 
plate. You can create your own TMPL 
resources, or you can use program 
editors like the bit-map editors used 
extensively in ResEdit. 

Using TMPLs means you don’t 
need to decipher the esoteric hexa- 
decimal listing of the bytes in a re- 
source, and their use generally makes 
the editing of resources extremely 
easy. 

ResEdit does not let you edit files 
currently in use (for example, you can- 
not edit the Finder when running un- 
der the MultiFinder), but it does allow 
the editing of system files. 

Warning: Do all your editing on a 
copy of the original file. Working with 
ResEdit on original files can cause all 
sorts of damage and unpredictable 
results to your operating system. 


Icons 


Some of the most common resource 
types can be changed quite easily with 
ResEdit. This includes one of the most 
obvious aspects of the Macintosh inter- 
face: the icon. 

Icons can be presented through the 
Finder (the Macintosh’s file manage- 
ment system) or from within applica- 
tions in dialogs and alerts. They are 
made up of a 32x32 (16x16 for small 
icons) pixel grid, and can be either 
monochrome, 4-bit color or 8-bit color. 
The color type used is determined on- 
the-fly by the Macintosh, so that the 
icons are displayed at the maximum 
possible quality. 

Icons are grouped into several re- 
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source types: 


e ICN# — monochrome 32x32 
pixel icons; 


° ics# — monochrome 16x16 
pixel icons; 


¢ icl4 — 4-bit color 32x32 pixel 
icons; 


¢ ics4 — 4-bit color 16x16 pixel 
icons; 


* icl8 — 8-bit color 32x32 pixel 
icons; 


¢ ics8 — 8-bit color 16x16 pixel 
icons; 


e ICON — monochrome 32x32 
pixel icons (without mask). 


Masks are used by all versions of 
icons, except ICONs, to determine 
which parts of the icons are to be trans- 


parent. Any dot on the mask makes 
the corresponding dot on the icon 
opaque, and masks are mainly used 
for stopping background patterns and 
colors from interfering with the image 
in the icon. 

The mask can also be used to make 
the icon appear to change shape when 
it is selected, as the interaction be- 
tween the mask and icon pixels is 
based on the Boolean OR operator. 
Although this can be very effective on 
white backgrounds, the results look 
rather unsatisfactory on patterned and 
colored backgrounds. 

Icons can also be assigned to menu 
items to clarify their meaning. How- 
ever, this looks strange when large 
icons are used and only some of the 
items have icons assigned to them — 
the spacing of the items then becomes 
highly irregular. Small icons (SICNs) 
can be assigned as well, giving more 
consistent spacing, although the icon 
image area is reduced. 

Within ResEdit, icons of all types 
are edited via a consistent bit-map 
editor interface (see Figure 1). The vari- 
ous editors allow the user to carry out 
MacPaint-like operations on icons, in- 
cluding cut and paste. 

You can, for example, screen-cap- 
ture a particular ‘scene’, then copy a 
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MiniFinder button directory ID 
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Code that is run at system startup time 

nstaller Script 

0 International Formatting Information 

(replaces it10; no longer used) 
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Table 1. Common resource types 
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Ascii Mapping (software) 

old keyboard layout (used by old INIT 0+1) 
Keyboard Mapping (hardware) 
Keyboard/Script icon 

Keyboard Swapping 

Finder layout resource 

Code for drawing lists 

CDEV filtering 

Version # in system file 

Menu Bar 

Menu bar definition procedure (Code) 
Mouse Tracking 

Menu Color Lookup Table 

MacroMaker information 

MacroMaker information 

Code for drawing menus 

MacApp memory utilization 

Menu 

Macro info (MacroMaker) 

Default queue sizes for MakeITable 
MacApp menu table(relate command # to menu) 
MPP Configuration Resource 

NBP configuration (AppleTalk) 

THe KONE (EloNASE OES; 

Font Description 

Rectangle position list 

Packages of code used as Rom extensions 
Printer Access Protocol Address (AppleTalk) 
Quickdraw Pattern 

Quickdraw Pattern List 

Code to drive printers 

Quickdraw Picture 

Color Palette 

Postscript — found in Laser Prep file 
Pixel Pattern 

Array of ppats 

Printer driver’s private data storage 
Default page setup info for printer 
(PRED fd = 0) 

Print record (PREC id = 3) 

Just a string 

Rom Patch 

System 7.0 query resource 

Rom Resource Override 

Screen Configuration 

MacApp 

Ram serial driver 

Small Icon 

MultiFinder Size Information 

Sound 

PascalStyle String 

PascalStyle String List 

Style information for TextHdit 
Unlabeled string. (Same as minf 
THe: Mast 

ResEdit template 

Application version information 
Window Color Lookup Table 

Code for drawing windows 

Window Template 

Query str used by qrsc resource 


Table 1. Common resource types (cont.) 
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portion of it from MacPaint into Res- 
Edit, rather than building the image 
up from scratch. If the copied image is 
larger than the icon size, it is centered 
on the icon area, and you are able to 
move the image to display the desired 
portion. Icons within the Finder can 
be changed to personalize the default 
application, file and folder icons. The 
Trash icon can also be changed, and 
some public domain variations include 
bat caves and toilets. 

There are innumerable icons avail- 
able through the public domain, with 
the most common being those for 
HyperCard and the Finder. 


Cursors 


Cursors, like icons, come in various 
guises, but rely on the same basic re- 
source — CURS. This is an 8x8 pixel 
monochrome bit-map. 

There are two types of cursor (or 
more accurately, two utilizations of 
the basic cursor resource type): 


e CURS — monochrome 16x16 
pixel ‘run-of-the-mill’ cursors; 


° acur — a list of CURSs for use 
in animated cursors (the 
moving watch, for example). 


Basically, cursors tell you the posi- 
tion of the screen pointer, as controlled 
by the mouse. They can be the normal 
arrow cursor, the watch cursor when 
time-consuming actions are taking 
place, or anything the developer 
chooses, such as I-beam cursors in 
word-processors. By using the acur 
resource type (Figure 2), you can 
specify a series of cursors to be dis- 
played, one after the other. This can be 
used to achieve animations, the most 
common example being the watch 
cursor where the hands revolve 
around the face of the watch. 

Cursors require one additional 
piece of information — their ‘hot-spot’. 
The hot-spot is where the pointer ac- 
tually is. In cross-hairs, for example, it 
is the intersection of the line making 
the cross hairs; on an arrow, the hot- 
spot is at the point of the arrow. The 
Macintosh considers the current 
mouse action to be occurring at the 
hot-spot, rather than over the whole 
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Figure 1. ResEdit’s icon bit-map editor 


cursor. 

ResEdit allows the editing of cur- 
sors, including the hot-spot (Figure 3), 
in a bit-map editor which also dis- 
plays the cursor against white, black 
and checkerboard backgrounds. 

Cursors, like icons, have masks. It 
is highly advisable to make the maska 
filled image of the cursor itself to en- 
sure the cursor looks its best. The mask 
can extend beyond the edge of the 
cursor’s image, as in the Macintosh’s 
normal arrow cursor where this tech- 
nique allows a border to appear on the 
arrow when itis placed on black pixels 
in the background. 

Cursor Animator, from Wilhelm 
Plotz, is a Control Panel Device 
(CDEV) which lets you replace any 
system cursor with one of the many 
supplied animated or static cursors. 


Fonts 


Animportant concept with the Macin- 
tosh interface is ‘what you see is what 
you get’ (Wysiwyg). With Wysiwyg, 
the screen display matches the printed 
output as closely as possible. This was 
originally achieved (before the laser 
printer) through the use of screen 
fonts, of the resource type (not sur- 
prisingly) FONT. 

FONT resources are basically bit- 
mapped representations of the letters 
within a font, along with some for- 
matting information. To achieve the 
‘high quality’ printing option (almost 


150 dots per inch), when printing 12 
point text, the 24 point screen font 
(which is 72 dpi) is reduced 50 per- 
cent, while retaining all the bit- 
mapped information. This means that 
users generally have more fonts than 
they actually use, increasing system 
file size. 

Users of laser printers need not 
worry about this: only one size of 
screen font need be installed. The ex- 
ception to this rule is the range of 
printers which do not use outline font 
technology (Apple’s Personal Laser- 
Writer SE, for example). For these 
printers, a screen font of four times 


the required font size is read in to 
achieve resolutions approaching 300 
dpi. 

The FOND resource is used to store 
the name of each font family. Each 
font family has a unique ID between 0 
and 255. A particular font size has the 
ID: 


Font Family ID number * 128 + Font Size 


This means that the screen font for 
New York 12 pt has an ID of: 


2 * 128 + 12 = 268 
(The New York font family ID is 2) 


Apple has reserved ID numbers 0- 
127, leaving only 128 for the numer- 
ous other fonts available. This leads to 
the possibility of ID conflicts, which 
versions 3.8 and later of the Font/DA 
Mover have attempted to overcome. 
If ID conflicts still occur, you can use 
ResEdit to change the ID of the family 
and individual sizes. 

As resources, FONTs are easily 
edited with a variety of utilities, in- 
cluding ResEdit. Once again, ResEdit 
presents the user with a MacPaint- 
like bit-map editor, with each letter 
edited separately (see Figure 4). You 
can also alter attributes such as letter 
height, baseline position and letter 
spacing with ResEdit. 

If you wish, you can create a font 
from scratch, although generally it is 
easier to find a font similar to the one 
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Figure 2. The acur resource, showing a list of cursors to be displayed 
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required and then edit it to taste. Fonts 
are also available in the public do- " @ File Edit Resource Window Transform CURS 
main and from commercial suppliers 
for a wide range of uses. 


URS ID = 257? from Finder 


Menus 


Menus are another important part of 
the Macintosh interface. As a resource, 
they are basically a list of items, with 
keyboard equivalents sometimes as- 
signed to these items. When a menu 
item is chosen from within an applica- 
tion, the code of that application reg- 
isters the choice and carries out the 
appropriate action. Unlike, say, the 
menuing system in Command Post 
(the utility for Microsoft Windows) 
which is a programming language in 
itself, the menus on the Macintosh are 
‘dumb’, with the code determining 
the actions to be taken stored else- 
where in the file. 


SIE Suiehy 


Figure 3. ResEdit’s cursor bit-map editor, showing the cursor’s hot-spot 


ing information (Figure 5). You can e The font ID and size of file 


The Macintosh system automati- 
cally determines the minimum width 
for the menu items, and adds space 
for the keyboard equivalents. You can 
add separator lines — dotted lines 
which cannot be selected — to break a 
menu into groups of functions. Any 
character can be used in a menu, in- 
cluding spaces and punctuation 
marks. 

One of the biggest complaints about 
menus is the lack of keyboard equiva- 
lents for menu items. You can add 
these menu shortcuts easily with 
ResEdit, along with color and text styl- 


also assign icons to menu items, and 
disable items if they are not available 
by default. When disabled, either by 
ResEdit or on the fly by an applica- 
tion, the item is grayed with a check- 
erboard pattern. 


Finder Layout 


A large amount of layout data for in- 
formation displayed by the Finder is 
contained in the LAYO resource found 
within that file. The LAYO resource 
controls: 


names, 


¢ The default dimensions of 


windows for folders and disks; 


e Line spacing, page margins 


and column positions for file 
lists; 


¢ Spacing details for icons; 


¢ Whether an application 


window zooms from the icon 
size to the window size when 
a file or application is opened; 


¢ Whether the system warns of 
program or system file deletes; 


e¢ Whether icons are constrained 
to the spacing grid when they 
are moved; 


The quick brown fox jumps over 
the lazy dog. 


¢ The maximum number of 
windows allowed to be open 
at any one time. 


A particularly handy group of op- 
tions within the LAYO resource deal 
with icon spacing. By setting the ‘Icon 
vertical phase’ to a number around 
20-30 you can offset adjacent columns 
by this amount, thus reducing the in- 
cidence of file names running into ad- 
jacent files’ icons (see Figure 6). Icons 
can be placed closer together verti- 
cally or horizontally as well. When 
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Figure 4. Fonts can be edited to include custom characters or to improve appearances 
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used in conjunction with the ‘Always 
grid drags’ option, this ensures the 
windows presented by the Finder re- 
main neat and legible. 


International Settings 


Individual countries have different 
standards for the way dates, numbers 
and measurements are displayed. 
Many users also have personal prefer- 
ences. Rather than using a‘/’ to sepa- 
rate date items, you may prefer to use 
‘in order to avoid misreading the ‘/ 
“asa‘1’. The order used in displaying 
dates (such as M/D/Y or D/M/Y, 
amongst others) can also be a per- 
sonal preference. For example, a jour- 
nalist in England who constantly 
writes articles for the U.S.A. may want 
to use the U.S. options as the default. 
All of this information, together 
witha host of further information such 
as the names of days of the week and 
months, is stored in the INTL, itl0 and 
itll resources (see Figure 7). The stand- 
ard settings for a country can be se- 
lected from a wide range, and then 
altered to the user’s needs. The INTL 
resource with id=0 is, in fact, the same 
as the itlO resource, and the INTL re- 
source with id=1 is the same as the itl1 
resource. Most country settings are 
selected by choosing a country froma 
list, and then you can further custom- 
ize any of the other standards for a 
particular country with ResEdit. 
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Figure 5. Keyboard equivalents, font styles and color can be assigned to menu items 
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Dialogs and Alerts 


Dialogs and Alerts are used whenever 
the user is required to change a setting 
ina program, or if the system needs to 
inform the user of important informa- 
tion (system crashes and the like). For 
obtaining information from users, 
dialogs (resource type DLOG) are 
used; for merely informing the user of 
an occurrence, alerts (resource type 
ALRT) are used. 

Dialogs and alerts are made up of 
buttons, check items, icons, pictures, 
text blocks (static and editable), win- 
dow type, size and position informa- 
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Figure 6. With the Icon Vert. phase set to 16, file names do not overlap 


tion. These are stored in the DITL 
(dialog item list) resource type, which 
is called when a dialog or alertis called. 
Program data can be included in the 
text blocks, and willbe displayed when 
the dialog is called. 

For dialogs and alerts, ResEdit 
presents a MacDraw-type editor (Fig- 
ure 8) and allows the aligning of ob- 
jects to the grid or to each other. You 
can create, add and modify individ- 
ualitems, and youcanalso move items 
in front of or behind other items if 
they overlap. Every time an item is 
moved forward or back, its number in 
the DITL also changes to reflect its 
‘depth’. The DITL editor is shown in 
Figure 9. 


BNDLs and FREFs 


When an application needs to per- 
forma file operation, or when it is first 
loaded into the Finder, the Finder looks 
for a series of resources called BNDL 
and FREF and copies them into the 
Desktop file. BNDL and FREF control 
the file-type and creator attributes — 
four-character variables, usually in- 
visible to the user. The creator indi- 
cates the application which created a 
particular file. These resources also 
tell the Finder the icons to use with 
each particular combination of file- 
type and creator the appli cation may 
create. 

For example, Teach Text text files 
have a file-type of TEXT and a creator 
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Figure 7. Country defaults are contained in the itl0 resource 


Version: 


EJ metric 


of ttxt, while Microsoft Word text files 
have the same file-type and a creator 
of MSWD. The use of the file-type and 
creator attributes allows the file to be 
opened by the application which cre- 
ated it by simply double-clicking on 
it, while other applications may be 
able to read the file-type, even if they 
were not the creator. In the latter case, 
you load your applications program 
and then try to open the file, instead of 
double-clicking on the file. If the file- 
type is readable by your application, 
the file will then be opened. 

So, BNDLs and FREFs tell the 
Finder the relationships between ap- 
plications, their specific data files, and 
the icons used to represent both. The 
BNDL editor of ResEdit lets you bun- 
dle the various pieces of information 
required by a BNDL resource with a 
graphic representation of the resources 
used. 


Sounds 


The Macintosh interface now allows 
the inclusion of sounds in files, as snd 
resources. Sound resources are a list 
of digitized sound information. 
Although they cannot be edited 
with ResEdit (except as hexadecimal 
values), sound resources can be cut, 
copied or pasted between files, and 
they can also be played — at normal 
speed, at a series of pitches through a 
chord, or as a HyperCard sound. 
Sounds are usually handled differently 


by HyperCard than by other applica- 
tions, which is why a sound can be 
played as a HyperCard sound. 


Patterns 


If you want a personalized desktop, a 
background pattern can be chosen 
from a list of 32 presented in the Con- 
trol Panel. These patterns, repeated 
(tiled) bit-maps of 8x8 pixels, are stored 
by the system as PAT# resources. They 
can be edited in a simple bit-map edi- 
tor in ResEdit (Figure 10), and this 
editor’s only function is to allow you 
to turn pixels on and off. 


Each resource of type PAT# is, in 
fact, a list of 32 patterns, through which 
you can scroll. A representation of the 
pattern at normal size is also provided 
so you can get an idea of what the 
pattern will look like. These patterns 
are also used by HyperCard, 
MacPaint, and other Paint-type pro- 
grams. 

For scroll bars, opened icons and 
other system items, the patterns used 
are stored in PAT resources, which 
can be edited in a bit-map editor simi- 
lar to that for PAT#s. 


Strings 


Applications will often require strings 
to be displayed to the user and, rather 
than hard-coding these into the pro- 
gram, the STR# resource type is often 
used. Using the STR# resource allows 
a list of strings to be stored in one 
place, which makes, for example, 
translating to a foreign language eas- 
ier. 
An example of a STR# is found in 
the Finder: this STR# carries informa- 
tion such as the names of items like 
the Trash, the text to be added to a 
file’s name when it is duplicated (to 
avoid name conflicts), and so on. The 
STR# resource contains the list of 
strings to be used, and the calling pro- 
gram accesses these strings by request- 
ing the required string by its position 
in the resource. Individual strings can 
also be stored in the STR resource type. 
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Figure 8. The attributes of dialogs are edited with the DLOG editor 
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DITL 1D = 819? from Finder : article also apply to aspects of Win- 
: dows 3.0 in the IBM PC compatible 


y Ge] Check Box : environment, although there is not a 
widely available editor for these ele- 

ments for Windows. 
Upon startup, automatically open: One editor Windows users may 
O consider using is Icondraw, from 
(2 Opened Applications and DAs i Philip Eskelin. When used in conjunc- 
© *0 Only i tion with PBIcon (from Impact Soft- 


: ware) and Microsoft Paintbrush, Icon- 
User It : : one : 

Veancet) : sesh draw provides similar functions to Re- 

: sEdit’s icon drawing capabilities. Both 

IconDraw and PBIcon are shareware. 
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Width: | Where to get ResEdit 2.1 


ResEdit 2.1 is available on the PCSA 
bulletin board system as a MacBinary 
file along with ResEdit Primer, a handy 
introduction to resources and using 
ResEdit, and additional templates for 
ResEdit to open and edit acur, SIZE 
CODE and snd resource types. Re- 
quests for the ResEdit 2.1 manual can 
be made through your local Apple 
Programmers and Developers Asso- 
ciation office (APDA), or through 
bookstores. 
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APDA Addresses 


70. Be US. 
Apple Computer 
20525 Mariani Avenue, M/S 33-G 
: Cupertino, CA 95014-6299 
Figure 10. Patterns can be “tested” on the desktop with the PAT# pattern list editor Ph: 1-800-282 2732 (U.S.) 
1-800-637 0029 (Canada) 
1-408-562 3910 (International) 


U.K.: 

Apple Computer Ireland 
Warrington House 
Mount Street Crescent 


Warning: Resources are an essential part of the way the Macintosh works. 
Changes to program files, and particularly system files, can result in system 
crashes. 

To avoid damage to your system and program files, please ensure any Dubli 

: ” ; aa ublin 2 

changes are carried out on copies of files only, never on the originals. Even Ph: 353-1-604233 (International) 
if the altered file continues to work as before, keeping the original file is an : 
added level of security in case uncommon operations cause the system to Australia: 
crash. All users should ensure they understand the changes they are making Apple Computer Australia 
before going ahead with those changes. 16 Rodborough Rd 

It is recommended that a boot disk be prepared before carrying out Frenchs Forest NSW 2086 
changes with ResEdit. Ph: 61-2-452 8213 (International) 
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